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Fronter integration setup guide 



Fronter Y12 

This documentation was produced by Fronter - www, fronter, com 
Tliis document can only be copied or distributed according to contract or 
agreement witli Fronter. 



New in this manual: 

• Tliis is a brand new manual 
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Preface 

This document covers the new version of the Fronter integration setup tool. The 
target group is administrators in schoools. 

The purpose for both tools is to set up user and group imports from external 
applications to a Fronter building. 

Before you set up an integration, you should have read the documentation 
available in Fronter's integration package that is available from the Fronter 
support site. 

Fronter is continually being developed and improved. Discrepancies may 
therefore occur between documentation and application. This guide is written for 
Fronter Y12 in March 2013. 

How to get the tool 

To have the integration setup tool available (old or new) you need to contact 
your local service desk to have it activated. 

If you already have imports defined in the old ''Fronter integration setup" tool 
you will need to be migrated. Please contact your local service desk to plan the 
migration. 

If you have a new building, or a building where no imports are defined you will 
get the new tool by default. 

Where do I find the tool 

Admin > Tools > ''Fronter integration setup" 
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Overview 

The first screen you see is an overview screen 

Org. unit Settings Statistics Tools Absence, grades and order Support 

® Structure root 
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Web service- based database synchronization tool. 



4- Import Configurations 

Below are the defined MIS integration connguration('s) for this node, Please note: ir the integration is greyed out this indicates that the MIS integration is inactive 
and data will not be imported into Fronter until it is re- activated. 

Define a new import. 

□ Name Created by Created Action 



This is where you can administer imports already created, and create new ones. 
Options are: 

• Activate 

This activates a deactivated import by entering it into the nightly 
scheduling system. 

• Deactivate 

This deactivates an active import and removes it from the scheduling 
system 

• Delete 

• Run now 

This enters an integration into the queue system, and it will be run when 
resources become available. During the day there is usually little activity 
but it can take some time if there is already a number of integrations 
running. 

Defining a new import 

1) Click ''Define a new import" 

2) Based on your geographical region the tool gives you an option to choose 
from a number of templates. 

You can of course choose ''All regions" to get a list of every template. 
In addition to region specific templates each region list also contain the 
more general options: 

a) General MIS import with UAS (A standard import where we can pull 

or receive and IMS XML file and import it via our User 

Administration System) 
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b) General MIS import without UAS (A standard import where we can 
pull or receive an IMS XML file and import it.) 

c) Custom template (this allows you to freely choose from all plugins 
available for the selected region) 

For info on regional options, please review region specific documentation. 
When you are done setting which region and template you want chose 
"Next step" 



General 



Step 1 of 8 - General 



Region selection 

[ United Kingdom it] 

Template selection 
[ General IMS with UAS 



II^S Enterprise XML import with User Administration System for creating usernames 
and SingleSignOn support 




3) The transfer step 

Imports are based on files with data and these files need to be transferred. 
You can either push files to our server, or have us fetch them. 
Based on which template you chose you might get an option here, or it 
might be grey meaning that there is only one option here. 

e.g if you have chosen the template ''Sims.net template" you won't get 
any options here, but if you have chosen ''Itai xcal template" you will have 
to choose between: 

a) FronterTransferDummy 

b) FronterTransferFTP 

c) FronterTransferlnsecureCurl 

d) FronterTransferScp 

e) FronterTransferSftp 



step 2 of 8 - Transfer 



Transfer pi u gin selection 










Fronts rT ran sfe rFtp 






FronterTran &fe rlfi se cu reC uf 1 






Fronte rTran &fe rSc p 






FronterTran &fe r5f tp 


1 options 




For more info about that how the different transfer options work please 
contact the local service desk. 
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Ftp, scp, sftp and insecure curl are all ways of transferring files. 

Based on which option you chose you then have to fill in the info we need 
to find the file. 



step 2 of 8 - Transfer 



Transfer plugin selection 
l [ FroFiterTransferScp t-^-j 
Generic SCP-based transfer plugin 
ConRguration options fortliis piugin: 

Generic options 

School URL 

Export prinnary niename 
Export secondary diename 
Export username 

Use public l<ey authentication (requires key}? 
File name of private l<ey 




I 




4) The translator step 

This step does a set of modifications to the file to make it into a format 
Fronter supports. The format is IMS Enterprise. 

Again, you might not have any options here depending on what template 
you have chosen. 

If we are provided an IMS xml file from the customer a dummy translator 
stage is most often chosen. 

An example of a template with options here is General SIF, where you are 
able to choose between the FronterTranslatorSIF translator and the 
FronterTranslatorEnterprise translator. 



5) Tuner step 



This stage performs some final tuning adding Fronter specific extensions to 
the IMS format file, provisioning users and making additonal changes to 
the data prior to importing. For example this can be what format the 
username should have, adding rooms etc. 

Update all: If you turn on ''Update all" it means that every time an import 
runs it starts from scratch, so all groups, nodes etc. that were created by 
the import are removed and the structure is rebuilt. 

Create new username for person: Should Fronter create a new username 
and if so which format should it have 
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Use password generation: If the import should generate password the type 

of password should be set here. 

Set e-mail as login: E-mail is set as username 



General Transfer 


Translator 


Tuner 





Step 4 of 8 - Tuner 



Tuner plugin selection 



[ CreateUsersTuiier 



Tuner plugin on user creation 
Configuration options for this plugin: 
Generic options 



Update all 
Person 



Create new username for person 
User password generation 
Set email as login 



[ Use externali username 



[ Complex, high security 
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6) Importer step 

The final details for your import are set here. 



General 


Transfer 


Translator 


Tuner 


Importer 





Step 5 of 8 - Importer 



Importer plugin selsction 






[ FronterimporterlmsEnterprise 






Generic innporter plugin oFIMS Enterprise data 






Configuration options for tills plugin: 






Carer 






Carer absence access 




□ 


Carer ILP access 




□ 


Carer portfolio access 






Generic options 






Deactivate logins on past users 




□ 


Group access 


f View (100) 




Update existing groups 




□ 


Create non- existing groups on update request (recstatus=2} 




□ 


ImportID is unique 






Create no- existing roonns 






Access level for nn embers in rooms 


f No Access £0) 




Tool list ID for rooms 


[ Herramientas bisicas salas 




Update existing rooms 




□ 


Sl<ip group moves 






Update all 




□ 


Username is unique 




□ 


Web service is synchronous 




□ 
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Carer: 

If your import supports import of caregivers you can set in tlie import 
stage if tliey should be granted access to absence, ILP or portfolio by 
default. 

Generic: 

Deactivate login on past users: 

if a user is removed from all groups, should they also be disallowed from 
logging in 
Group access: 

What access a group should have on itself 
Update existing groups: 

If a group is set to be created but already exists, should it be updated 
Create non-existing groups on update reqstatus (Recstatus = 2): 
If a group does not exist and a modify group request is received, should it 
be created? 

Rec status originally means that we will only update existing groups. This 
setting how ever makes sure that even if we send records with update, 
they are created if they do not exist. 
ImportID is unique: 

states that importid is unique, which is not always the case. In most 
scenarios it is the combination of importid and importsource that is 
unique. 

Create no-existing rooms: 

If we get an update of a room in the xml file and it does not exist, should 
we create it 

Access level for members in rooms: 

What access should a user have in a room (read, write, delete, owner,none) 
Tool list ID from rooms: 

If every generated room should get the same toolbar choose that here. 
This can also be set in the file to have different toolbars for different types 
of rooms. 

Update existing rooms: 

If we receive a create request for a room that already exists, should we 

update it? 

Skip group moves: 

If a group already exists but with another parent than is in the incoming 
file, this states if we should move it or not. 
Username is unique: 

If this is on, the import will match incoming data to users in the building 

based on username. 

Web service is synchronous: 

If your import uses web services and this option is on, it means that the 
moment we find that there is a new file available we will import it, and not 
(only) at the scheduled time. 
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Email 

Mail default folder 
Mail description 
Mail doinain 

Fronter is mail liosting institution 

Mail draft folder 

Mail sent folder 

Mail server directory 

Mail trasli folder 

Mail type 

Mail delete action 

Use Fronter password as mail password 
Mail server 

External mall account access 
Mail uses SSL 

Person 



[ MAP 14^ 

[ Move to trash 

□ 



□ 
□ 



Create no-existing users 
Sliow location 
Sliow organization 
Sliow postal code 
Sliow street address 
Show phone number 
Tool list ID for users 
Skin 

Users must change password 
Set email as login 
Use tools on top 
Update email on users 
Update password on users 
Update real name on users 
Update existing users 



□ 
□ 
□ 
□ 
□ 

r MeniJ liorizontal {Padfes de farm ilia) Mi| 
I Classic^ 

" □ 
□ 

□ 
□ 
□ 



E-mail: 

This will add an e-mail account to the Fronter e-mail client. These are the 
general settings that can apply to any account. 



Person: 

Create no-existing users: 

if we get an update for a user that does not exist, do we create it 
Sliow location, organization, postal code, street address, phone number: 
Should these fields on the contact card be updated 
Tool list ID for users: 

If all users should have the same personal toolbar input this here. This can 
also be set in the file to make it possible to let students and staff have 
different toolbars. 
Skin : 

The default design chosen. Standard designs from Fronter are Classic and 
Play. 

User must change password: 

Set if the user has to change password the first time they log in after 
being imported. This will only be for newly created users. 
Set email as login : 

If e-mail is available that will be set as username. 
Use tools on top: 

Decides placement of personal toolbar. 

Update e-mail, password, real name, skins, username, existing users: 

Should these fields be updated from the import 

Use Fronter mail: 

Fronter is the e-mail provider. 
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7) Finisher 

Tine finislier liandles bespoke activity tliat doesn't fit under any of the 
other steps. 

This can for example be updating passwords for customers using Idap 
authentication, or to create an export to another identity provider. 

8) Global import setting 

This step lets you fill in the contact e-mail for the admin, which log level 
you want (Message is pre-chosen) and give a short, descriptive name for 
the import. 

9) Scheduling 

Set up when you want your import to run. 

If no time is given the import will run at random time between two times 
set on the server. (12-05 at our main hosting center) 
Press save and you have configured your import. 

Log verbosity level: What should be displayed in the log. Recommendation 
is ''Message". The most important ones are severe, critical and fatal. 
A severe error will not stop the import, but you might be missing e.g. a 
student record. 

A critical error will stop the import, but it will be a controlled stop so it 
tidies up inconsistent data. 

Fatal means import stopped and there may be data inconsistency. 
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